home *** CD-ROM | disk | FTP | other *** search
/ MPEG Toolkit / MPEG Toolkit.iso / dos / layer3 / manual.txt < prev    next >
Encoding:
Text File  |  1997-01-01  |  6.3 KB  |  151 lines
  1. Manual.txt for Version 0.99a of ISO/MPEG Audio Layer 3 software only 
  2. encoder/decoder.
  3.  
  4. 1. ENCODER
  5.    =======
  6.  
  7.  L3ENC.EXE and L3ENC_FP.EXE are ISO/MPEG Layer III software only encoders. 
  8.  They take raw PCM audio data files as input and deliver Layer III coded bit
  9.  stream files as output. Several options can be selected via command line 
  10.  switches. 
  11.  Usage:
  12.  
  13.    L3ENC <PCM audio data> <bitstream> [-switch1 [-switch2 [...]]]
  14.    L3ENC_FP <PCM audio data> <bitstream> [-switch1 [-switch2 [...]]]
  15.  
  16.  L3ENC.EXE should work on any IBM PC compatible computer. L3ENC_FP requires 
  17.  a 386 type CPU or better with external or built in 387 hardware floating 
  18.  point support. A 486DX CPU or better is recommended.
  19.  
  20. 1.1 PCM audio input file
  21.  The first command line argument specifies the name for the PCM audio
  22.  data file. Version 0.99a of the encoder accepts only one input format: 
  23.      raw PCM audio data files with two interleaved channels of 16 bit 
  24.      signed integer samples. The sampling rate must be 44.1 kHz.
  25.    
  26.  <sample #1 channel #1> <sample #1 channel #2> <s.#2 ch.#1> <s.#2 ch.#2> ...
  27.  
  28. 1.2 bitstream output file
  29.  The second command line argument specifies the name for the bitstream 
  30.  output file. As for now there is no default value for the filename or for 
  31.  the extension of the file name. The format of the bit stream is as defined 
  32.  in the ISO/MPEG publication IS11172-3.
  33.  
  34. 1.3 encoding mode
  35.  Depending on the setting of the '-mod' switch, the encoder will treat the 
  36.  two input channels as:
  37.     -mod 1  stereo (joint stereo),
  38.     -mod 2  mono audio data.
  39.  
  40.  Default is joint stereo. 
  41.  For stereo, the first channel is the left channel. The second channel is 
  42.  the right channel.
  43.  For mono mode the mono signal is calculated from the stereo input data as:
  44.       <mono sample #n> = (<s.#n ch.#1> + <s.#n ch.#2>) / 2
  45.  i.e. mono = (left + right) / 2
  46.  
  47.  Version 1.0 of the Encoder will have true mono input options.
  48.  
  49. 1.4 sampling rate
  50.  Version 0.99a of the encoder is restricted to 44.1 kHz.
  51.  Version 1.0 of the encoder will support 32kHz, 44.1 kHz and 48 kHz.
  52.  
  53. 1.5 bitrate
  54.  The bitrate of the bit stream output is selected via the '-br' switch.  The 
  55.  bitrate is specified in bits/second. The bitrate is the total bitrate for 
  56.  all encoded channels, i.e. if you select 'br 128000' and 'stereo', both 
  57.  channels will be stuffed into one bit stream of 128000 bits/second. 
  58.  Currently only ISO bit rates are accepted by the encoder. Valid bit rates 
  59.  are:
  60.  
  61.  32k  40k  48k  56k  64k  80k  96k  112k  128k  160k  192k  224k  256k  320k   
  62.  
  63.  The default bitrate is 128000 bits/sec.
  64.  
  65.  Version 0.99a of the encoder is restricted to stereo bit rates greater 
  66.  than 64 kBit/s and to mono bit rates less than 320 kBit/s. 
  67.  
  68. 1.6 crc check
  69.  If '-crc' is asserted, ISO/MPEG1 crc checking is enabled. Without the 'crc' 
  70.  switch, crc checking is disabled.
  71.  
  72. 1.7 examples of switch settings
  73.     L3ENC infile.pcm out.bit -sr 112000 -cr
  74.     L3ENC c:\music\pcm\newage.pcm c:\bitstr\l3\newage.bit -mod 2 -br 64000
  75.             
  76.  
  77.  
  78. 2. DECODER
  79.    =======
  80.  
  81.  L3DEC.EXE and L3DEC_FP.EXE are ISO/MPEG Layer 3 software only decoders. 
  82.  They take Layer 3 bit stream files as input and deliver PCM audio data 
  83.  files as output. A number of options can be selected via command line 
  84.  switches. Usage:
  85.  
  86.     l3dec <bit_stream> [<PCM_audio_data>] [-switch1 [switch2 [...]]]
  87.     l3dec_fp <bit_stream> [<PCM_audio_data>] [-switch1 [switch2 [...]]]
  88.  
  89.  L3DEC.EXE should work on any IBM PC compatible computer. L3DEC_FP.EXE 
  90.  requires a 386 CPU or better with external or built in 387 hardware 
  91.  floating point support.
  92.  
  93.  If you specify no output file name, the bit stream is nevertheless 
  94.  (partially) decoded but PCM audio output is discarded. This option is 
  95.  only useful, if you want to check the correct format of a a bit stream 
  96.  file without actually producing any output. And yes --- this is much 
  97.  faster than the full decoding process.
  98.  
  99. 2.1 bit stream input file
  100.  The format of the bit stream input file must comply with ISO/IEC
  101.  IS11172-3. Currently there is no default file name extension.
  102.  
  103.  The decoder will process all valid Layer3 bit stream data without
  104.  restrictions to bit rate or sampling frequency.
  105.  
  106. 2.2 PCM audio data output file
  107.  Audio data is output as samples of 16 bit signed integer PCM data. 
  108.  The default format is raw PCM data and can be either one channel or 
  109.  two interleaved channels.
  110.     format of one (mono) channel PCM audio data:
  111.         <sample #1><sample #2>....
  112.     format of two channel (stereo) PCM audio data:
  113.         <spl.#1 ch.#1><spl.#1 ch.#2><sp.#2 ch.#1><spl.#2 ch.#2>...
  114.  If one or two audio channels are used depends on the encoded information in 
  115.  the bit stream. For stereo output data the first channel is the left 
  116.  channel. Information about sampling frequency and number of used channels 
  117.  is displayed at the beginning of the decoding process.
  118.  
  119. 2.3 RIFF/WAVE format
  120.  If selected by the '-wav' switch, audio data is output in RIFF/WAVE format 
  121.  (*.WAV) as used by Microsoft Windows. The audio data itself is still 
  122.  written as 16 bit PCM data as described in 2.2 but it is preceded by a 
  123.  WAVE-header. The WAVE-Header contains information about the number of 
  124.  channels (1 or 2), sampling frequency (32k/44.1k/48k) and used bits per 
  125.  sample (16).
  126.  
  127. 2.4 [Sound Header]
  128.  [description]
  129.  
  130. 2.5 skip frames
  131.  With the '-fb' option you can skip a number of frames in the bit stream 
  132.  before the decoding starts. '-fb nnn' skips the first nnn frames. Each 
  133.  frame contains 1152 samples of audio data. Depending on the used sampling 
  134.  frequency, the duration of a frame is calculated as 24 msec (@ 48kHz), 26.1 
  135.  msec (@ 44.1kHz) or 36 msec (@ 32kHz). 
  136.  
  137. 2.6 decode only nnn frames
  138.  If you want to decode only a certain number of frames, specify the '-fn' 
  139.  option. '-fn xxx' will decode only xxx frames (see also 2.5).
  140.  
  141. 2.7 search again after loss of synchronisation
  142.  Normally the decoding process is stopped, if a loss of synchronisation is 
  143.  detected, i.e. the synch information is incorrect. To enable decoding of 
  144.  partially damaged bit stream files, you may assert the '-sa' option. In 
  145.  this mode the decoding is not stopped and the file is searched for valid 
  146.  synch information until end of file is encountered.
  147.  
  148.     
  149. All brand names are registered trade marks of their respective owners.
  150.  
  151.